home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / ros403.zip / EXTERNAL.DOC < prev    next >
Text File  |  1991-03-31  |  3KB  |  58 lines
  1.                              External Programs
  2.  
  3. 1. Whenever external programs (doors, transfer protocols, archive viewers)
  4. are executed, ROS replaces several command line parameters with the actual
  5. values currently in effect.  The following table lists the parameters that
  6. can be referenced:
  7.  
  8.   Parameter       Description
  9.  
  10.   [ANSI]          "A" or "N" if ANSI is enabled or not
  11.   [COMP]          The name of the composite file (archive)
  12.   [CRATE]         The computer-to-modem data rate
  13.   [DISP]          The file used to display the contents of an archive
  14.   [FILE]          The name of the file being transferred
  15.   [MRATE]         The modem-to-modem data rate
  16.   [NODE]          The node initiating the external program
  17.   [PARITY]        The parity of the port
  18.   [PORT]          The comm port
  19.  
  20. 2. Two fields are used by ROS to determine what action it should take when
  21. it starts an external program:
  22.  
  23.   Second: if "Y", ROS will load a second copy of COMMAND.COM to start the
  24.           external program
  25.  
  26.   Swap:   if "Y", ROS will get almost completely out of the way, leaving
  27.           only a 4100 byte "stub" in memory while the external program runs
  28.  
  29. There are benefits and costs to using both of these fields.  When true,
  30. Second takes a little longer to run since it has to load COMMAND.COM from
  31. disk.  On the other hand, COMMAND.COM _must_ be used to interpret batch
  32. files.  Swap has even more effect at slowing things down since the ROS
  33. memory image (about 300,000 bytes) will have to be stored on disk if EMS
  34. memory is not available.
  35.  
  36. My personal preference is to leave each field as "N" unless the external
  37. program requires it on.  For example, TradeWars is pretty big and can't load
  38. if ROS is still around, so I have this door set to Swap.  However, when I
  39. want to look into an archive, I use Vernon Buerg's "FV" program that's
  40. pretty small.  To keep things as fast as possible, I have both swap and
  41. second turned off.
  42.  
  43. 3. Installing doors isn't difficult, but it may require some experimenting
  44. to get everything correctly interfaced.  The real problem is that door and
  45. BBS authors that can't seem to agree on interface formats.  Instead of
  46. continuing this trend by inventing yet another format, ROS creates TWO
  47. interface files in the most popular formats:
  48.  
  49.   DORINFOx.DEF - originally defined by RBBS, Opus, etc.
  50.   DOORSYS.DOC  - originally defined by DoorWay
  51.  
  52. In addition, several programs such as DOORMASTER can be used to change from
  53. these two formats to several others such as that required by PC-Board doors.
  54. There are literally hundreds of doors out there that can be interfaced to
  55. ROS.  Remember, if you can't get the single command ROS executes to do the
  56. whole job, don't hesitate to use a batch file (be sure to turn on "Second"
  57. if you do).
  58.